# id3-extract-cover

A simple utility used to extract album covers from id3v2 encoded mp3 files, used in [cmus-rg](https://notabug.org/strlst/cmus-rg).

### install (unix)

1. install taglib ([taglib.org](https://taglib.org/)) *with* development headers

2. use `make` to compile `cmus-rg`, or `make install` to compile and install to `/bin` (requires elevated permissions)

3. run with `./id3-extract-cover MP3`, or `id3-extract-cover` if id3-extract-cover has been installed to `/bin`

### features in need of implementation

one day for sure

- [x] support for mp3
  - [x] id3v2 header
- [x] support for flac
  - [x] id3v2 header
    - id3v2 in flac files seem to be extinct, wherever I searched I couldn't find any which actually have encoded id3v2 tags, but it's implemented (albeit untested) nonetheless
  - [x] flac header
- [x] support for ogg vorbis
  - seems to be a bit buggy and occasionally not work
- [ ] support for mp4

Note: id3v1 header cannot encode any images

### license

MIT
